
  =================
   MouseAxess 0.16      (RISC OS 4 version)
  =================

   1994-98 by Christian Flter
  <mailto:cfloeter@gmx.de>  http://lightning.prohosting.com/~cfloeter

  RO4 support by GUS (dedicated to Stefan Bellon)
  <mailto:gusuni@otenet.gr>


MouseAxess provides a number of various enhancements for the RISC OS desktop.
Once installed, the following functions are available:

* Window functions:

  - Scrolls a windows work area by holding MENU + dragging
  - Drags a window on which the mousepointer stands with MENU + SELECT/ADJUST
  - Performs a page up/down if SELECT/ADJUST is clicked repeatedly while MENU is
    still being held down
  - Window menus will appear if MENU is released without dragging
  - Adjusts a window horizontally/vertically by dragging the vertical/horizontal
    scroll bar with MENU
  - Adjusts a window vertically (or moves it completely) by dragging the title
    bar with MENU

* Filer & Pinboard functions:

  - Opens directories, applications & files by clicking about 0.35 secs on em
  - ADJUST-dragging Filer icons moves the files instead of copying them;
    the Filer window remains open(*)
  - MENU + SELECT over a close icon iconises the window(*)

* Iconbar functions:

  - Clicking & releasing MENU at the screen bottom toggles the iconbar(*)
  - While dragging an icon the icon bar is toggled each time the screen bottom
    is touched with the pointer(*)

* Hiding windows:

  - Clicking & releasing MENU at the screen top toggles all visible windows so
    that they temporarily disappear from the desktop and vice versa to provide
    better access to the pinboard(*)
  - Clicking & releasing MENU at the top-right screen corner brings a menu of
    tasks which have currently visible windows on the desktop; a tick shows that
    a task has hidden windows:(*)

   SELECT : Brings the windows of selected task to the top
   MENU : Hides all windows except from the selected task
   ADJUST : Hides the windows of selected task

* Temporary directory:

  - Dragging a Save icon to the bottom-right screen corner saves the file
    to the temporary directory(*)
  - Clicking & releasing MENU at the bottom-right screen corner opens the
    temporary directory(*)


(*) = Not available with RISC OS 2.



- Commands of MouseAxess

  *Scrollby <digit>
  ScrollBy sets the window scroll speed for use with the MENU-drag scroll
  option of MouseAxess. A value of 0 sets the speed equivalent to the actual
  mouse speed, values of 1 to 9 increase speed.
  In desktop, the scroll speed can be input by typing Ctrl+Keypad digit. The
  default setting is 0.

  *MoveBack
  MoveBack brings all hidden windows back to the desktop.



- Bugfixes since version 0.14

  MouseAxess is now able to operate correctly with the following apps:

  -StrongMenu (crashed horribly)
  -Messenger (moving files with Adjust now works correctly while it is loaded)
  -ProFiler (moving files with Adjust works!)
  -Director (crashed AFAIR, special code included, see below)
  -Pluto (showed some failure with the window hiding mechanism)
  -ArcFax (crashed horribly)



- Special apps

  * !StrongMen/!StrongED
    Clicking & releasing MENU at the left screen border opens StrongMenus/
    StrongEDs File menu correctly. StrongMenu has a higher priority here.

  * !Director
    Director will show its file menus correctly when you click & release MENU
    on a window titlebar. This allows the correct use of MouseAxess window
    titlebar drag.
    Tested with version 0.21 of Director. I recommend that you dont use
    older versions.

  * Impression
    MouseAxess includes special code to cope with the various window
    compositions of Impression. It works with Impression Junior, Impression 2,
    Style and Publisher. However, Ive been reported that Impression Publisher
    Plus doesnt.



- Rules on dragging windows with MENU+SELECT/ADJUST

  Whether or not windows will (properly) move when you use the
  MENU+SELECT/ADJUST drag on them depends on their window flag settings.
  If you try to drag a pane (or subwindow), MouseAxess will try to find out its
  tool window and drag this rather than the pane. Note that this will only
  work if that subwindow has its pane flag set, otherwise it will move
  without its tool window.

  If a window has neither its pane flag nor its moveable flag set, it wont
  move. If a window has a title bar and has its pane flag set, then a
  corresponding tool window will be searched to move instead, otherwise
  (ie. if pane flag is clear) it will be considered as a tool window and
  will move alone.



- The temporary directory

  Dragging Save icons from applications to the buttom-right hand screen corner
  will save the file into a directory 'Temp' located in the path variable
  MouseAxess$Path, which is set automatically when the !MouseAxes
  application starts up.
  You can equally set the path variable on your own. Note that a directory
  'Temp' is expected. If it cant be found, an error is given directly from
  MouseAxess, without disturbing the saving program.
  MouseAxess is still able to run independantly (ie. as single module),
  but then requires setting MouseAxess$Path manually.

  Note that this function is yet a little unstable in conjunction with the new
  window manager - this will be fixed in one of the next releases.



- Known interferences with other programs

  * !AllInOne     Multifunction tool. Prevents the auto-doubleclick from
                  working on (SparkFS-) archives when its '2nd Hand' option
                  is active. Turn it off.

  * !StrongED     Text editor. Do not use version 3.02 or earlier. It hangs
                  when you hide windows with it.

                  WARNING:
                  All versions crash almost instantly as soons as you drag
                  a StrongED window so that its left & upper parts are
                  completely outside the desktop. Unfortunately, Guttorm Vik
                  wasnt able to do anything about it before he left the Acorn
                  scene...
                  Workaround:
                  Go into the Global Choices dialogue and deselect
                  Display -> 'Use Fastchars when possible'.

  * !FormEd       Template editor. Older versions disturb the window hide
                  mechanism of MouseAxess. Use only newer versions by
                  Darren Salt (http://www.youmustbejoking.demon.co.uk).

  * !IconDir      File menus and hotkeys. Interferes MouseAxess dramatically.
                  Do not use it. Use !Director instead.

  * BugBuster     Debugger. Gives an exception error when MouseAxess starts
                  or terminates while BugBuster's "protect" mode is on.
                  Add *unprotect in MouseAxess' !Run file to fix this.



- Disclaimer

  MouseAxess is Freeware. You may copy it freely, as long as the application
  and its contents are left unchanged.

  Please note:

  I dont provide any guarantees that MouseAxess will work 100% correctly in
  all circumstances. USE IT ON YOUR OWN RISK!
  I will not be held responsible for any loss of data that (probably) occurs
  through the use of MouseAxess!



- Thanks...

  go to Stefan and Vincent, who werent getting tired of promoting MouseAxess
  wherever they could :-)

  My thanks also go to GUS (see top of file), who was providing this version
  in order to work correctly with RISC OS 4.

